본문으로 건너뛰기

신규 시스템 모니터링 설치 가이드

신규 시스템 모니터링 기능을 사용하려면 데이터 수집 서버 cloud-metrics-hub를 설치하고 아래 설정을 적용합니다.

On-Premise(폐쇄망) 전용 본 기능은 고객사 On-Premise(폐쇄망) Kubernetes 환경 전용입니다. 퍼블릭 클라우드·공용 클러스터·외부 노출 환경에는 설치하지 않습니다.

개요​

관리센터는 고객 클러스터 내부를 직접 보지 않고, 클러스터 안에 설치된 cloud-metrics-hub가 메트릭을 수집해 관리센터에 제공합니다. cloud-metrics-hub가 설치되어 있어야 시스템 모니터링 화면에 데이터가 표시됩니다.

설치​

helm install metrics-hub oci://scharbor.security365.com/helm/cloud-metrics-hub \
  --version 0.1.4 -n security365 --create-namespace

어플라이언스(OVA) 기반 환경에서는 설치에 필요한 기반 구성요소가 대부분 자동으로 구성됩니다. 수집 대상 주소는 자동 설정되므로 별도로 입력하지 않습니다.

설정 (아래 두 가지만 설정하면 됩니다)​

1. 관리센터 연결 및 메뉴 표시 (관리센터 portal-web-config)​

### portal-web-config
VUE_APP_METRICS_URL: "http://<cloud-metrics-hub 주소>:8080"   # 관리센터가 호출할 hub 주소 (운영값 개발팀 확인)
VUE_APP_USE_SYSTEM_MONITORING_NEW: true                       # 신규 모니터링 메뉴 표시 (기본 false)

2. 데이터 서비스 헬스 수집 (hub)​

데이터 서비스(Elasticsearch·RabbitMQ·Redis·MariaDB)의 상태를 수집하려면 주소(ConfigMap)와 접속 비밀번호(Secret)를 입력합니다. 실제 값은 고객 환경에 맞춰 입력합니다.

주소 — ConfigMap metrics-hub-config

METRICS_HEALTH_ELASTICSEARCH: "<host:port>"
METRICS_HEALTH_RABBITMQ: "<host:port>"
METRICS_HEALTH_REDIS: "<host:port>"
METRICS_HEALTH_MARIADB: "<host:port>"

비밀번호 — Secret metrics-hub-infra-health-secret

stringData:
  METRICS_HEALTH_ELASTICSEARCH_AUTH: ""                 # Elasticsearch는 비밀번호 없음 (빈 값)
  METRICS_HEALTH_RABBITMQ_AUTH: "<user>:<password>"
  METRICS_HEALTH_REDIS_AUTH: ":<password>"              # Redis는 사용자명 없이 :비밀번호
  METRICS_HEALTH_MARIADB_AUTH: "<user>:<password>"

기동 확인​

curl http://<hub-host>:8080/actuator/health

UP이 반환되고 관리센터 시스템 모니터링 화면에 데이터가 표시되면 정상입니다. (메뉴가 보이지 않으면 위 VUE_APP_USE_SYSTEM_MONITORING_NEW 설정을 확인하세요.)

참고​

  • 어플라이언스(OVA)를 사용하지 않아 기반 구성요소(사내 이미지 레지스트리·metrics-server·스토리지 등)가 자동 구성되지 않는 환경은 별도 사전 구성이 필요합니다. 구축팀에 문의하세요.
  • 수집 대상 주소(METRICS_URL)는 node-exporter 구성에서 자동 설정되어 별도 입력이 필요 없습니다.